home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / misc / alfie.com / ALFIE.DOC < prev    next >
Encoding:
Text File  |  1990-02-24  |  13.7 KB  |  373 lines

  1.                   Ad-Lib Fill-in Entertainment
  2.                              (ALFIE)
  3.  
  4.             Copyright (c) 1990 by Barbara L. Baser
  5.                       All rights reserved.
  6.  
  7.                            Version 1.0
  8.                         February 1, 1990
  9.                               
  10.                               
  11. What's it all about?
  12.  
  13. ALFIE generates  "fill in the blanks" party games similar to the 
  14. popular  Mad Libs commercial product.  Briefly, the idea is that  
  15. party guests  are asked for a list of words to fill in blanks 
  16. appearing in a story they can't see.  All they are told is  the  
  17. type  of  word  needed  next  --  noun,  verb, adjective, 
  18. exclamation,  etc.   When the whole story is read back with  the 
  19. blanks  filled in  by words chosen at random, the results are 
  20. usually hilarious.
  21.  
  22. The "story"  used by  ALFIE is an ordinary ASCII file, which can 
  23. be created with EDLIN or any other text editor you like.  Blanks 
  24. to  be filled  in are signalled to the program by one or two  
  25. characters starting  with the  "@" or "%" character.  For 
  26. example, a blank which will contain a noun  is indicated in the 
  27. text file by "@n" (no quotes are typed), while a past tense verb  
  28. is indicated by "@t" and a present-tense verb by "@v".
  29.  
  30. During the party, the computer presents the list of words by 
  31. type, then  displays the  completed story  with  the  blanks 
  32. filled in  by the  responses from  the guests.  If the story 
  33. turns out  to be  especially good,  it can be printed or the 
  34. merged file can be saved.
  35.  
  36. Enjoy!!!
  37.  
  38.  
  39. Setting up the input file
  40.  
  41. Use any text editor or word processor you like to create the 
  42. input "story",  so long as your editor can output a straight 
  43. ASCII file  with  no  control  characters,  and  with  lines 
  44. terminated by  the carriage  return (ASCII  13),  line  feed 
  45. (ASCII 10) sequence.
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                            - Page 1 -
  66.  
  67.  
  68.                        ALFIE Documentation
  69.  
  70.  
  71. Blanks to be filled in within the text file are indicated by 
  72. sequences of two or three characters of which the first must be 
  73. "@".  The second character determines the "type" of word: noun, 
  74. verb, adjective, etc., which the computer will ask for to fill in 
  75. the blank.  The following is the list of standard type codes 
  76. recognized by the program.
  77.  
  78.      @a        Adjective
  79.      @b        animal ("Beast")
  80.      @c        Color
  81.      @d        aDverb
  82.      @e        Expression (e.g., "Ods Bodkin" or "Gadzooks")
  83.      @f        Flavor (sour, yucky, etc.)
  84.      @F        Female person
  85.      @l        pLace
  86.      @M        Male person
  87.      @n        singular Noun
  88.      @o        Odor
  89.      @p        Plural noun
  90.      @P        Person
  91.      @t        verb, past Tense
  92.      @v        Verb, present tense
  93.      @V        "ing" form of Verb, e.g. walking
  94.      @#        number
  95.  
  96. In some  cases, the above list of standard types will not be 
  97. specific enough  for a given blank in your story.  For these 
  98. cases, ALFIE allows you to define three "special" types with the 
  99. codes @s1 through @s3.
  100.  
  101. "Special" type  codes aren't  required at all, but if one or more 
  102. are  used, the  prompt text  the computer  will use  in asking 
  103. for  the word  must be  defined on  the first  one to three lines  
  104. of the  text file.   For  example, to  add  the special types  "a 
  105. vegetable" and "an emotion", the first two lines of the story 
  106. must appear as follows:
  107.  
  108.      @s1a vegetable
  109.      @s2an emotion
  110.  
  111. "Special" prompts  are limited  to 30  characters,  and  are 
  112. terminated by  the carriage  return-linefeed sequence  (what the 
  113. computer normally produces when you hit the Enter key).
  114.  
  115. In the  above example,  when the  computer encounters @s1 in the 
  116. main  body of  the story, it will prompt the guests with the 
  117. message "Please type in a vegetable"; when it encounters @s2, it 
  118. will prompt "Please type in an emotion".
  119.  
  120. If you'd  like  to force the first lower-case letter  in the 
  121. response to be capitalized, use the "%" character instead of the 
  122. "@" character  in the code.   This  feature is  good for fillins  
  123. in  titles   and  starting  sentences.   Obviously, neither  the  
  124. "@"  nor the "%" character  may appear  in the main text.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                            - Page 2 -
  132.  
  133.  
  134.                        ALFIE Documentation
  135.  
  136.  
  137. When you're  entering the  main story  line, insert the type code 
  138. just  as if  you were  typing  a  word,  surrounded  by blanks.  
  139. If, for example, you enter
  140.  
  141.      See the @n run!
  142.  
  143. and the  guests enter  "dog" at  run time,  the line  in the
  144. final story will read
  145.  
  146.      See the dog run!
  147.  
  148. If, on the other hand, you enter
  149.  
  150.      See the@nrun!
  151.  
  152. the final product will read as follows:
  153.  
  154.      See thedogrun!
  155.  
  156. This is usually not the intended outcome, although it can be used 
  157. creatively for some special effects.  For example,
  158.  
  159.      See the @ns run!
  160.  
  161. produces the final output
  162.  
  163.      See the dogs run!
  164.  
  165. without requiring you to use the @p (plural noun) type code.
  166.  
  167. Terminate each  line  with  the  "Enter"  (carriage  return-
  168. linefeed) sequence.  These can be inserted at any convenient 
  169. position,  since  the  computer  reformats  the  text  after 
  170. inserting responses  in place of the type codes to make sure it 
  171. fits in an 80-column screen.
  172.  
  173. Because of  this reformatting,  if you  want blank  lines to 
  174. appear in  the final story you must enter into the text file one 
  175. more  blank line than the number you want.  For example, to have  
  176. one blank  line in the final story, enter two blank lines in the 
  177. text file at that position.  Also,  even though it's good style 
  178. to leave two spaces between a period and the beginning  of the 
  179. next sentence  normally,  this may cause a blank space at the 
  180. beginning of a new line  in ALFIE,  so it should be avoided.
  181.  
  182. After experimenting  a bit, you'll be able to tell how often and 
  183. where  in the  text  that  fillins  should  be  left  to maximize 
  184. the  possibilities for hilarity.  It's usually (but not always)  
  185. a good  idea to  space  fillins  several  words apart, since  
  186. consecutive  random  words  tend  to  read  as gibberish.
  187.  
  188. Where do  you get  "stories" to use as a basis for the game?  All 
  189. sorts  of  articles  work  well  --  horoscopes,  advice columns, 
  190. advertisements,  even recipes!  Just pick something short (at 
  191. first) and try it on an unsuspecting friend.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                            - Page 3 -
  198.  
  199.  
  200.                        ALFIE Documentation
  201.  
  202.  
  203. Running the game
  204.  
  205. Once you  have a  number of input files set up, you're ready for 
  206. an  evening's entertainment.  Seat one of your guests at the 
  207. computer and enter ALFIE.  As usual, all input should be followed 
  208. by the Enter key.
  209.  
  210. The computer  will first  ask for the name of the input text file 
  211. to  use.  Key in the name of one of your creations, and turn the 
  212. keyboard over to your guest.
  213.  
  214. For every location you set up with a type code, the computer will 
  215. prompt  for a  word or  words.   (Two  and  three  word responses 
  216. with  blanks in the middle are OK, by the way, but excessively 
  217. long  responses will  confuse  the  reformatting procedure.   
  218. Encourage your  guest  to  use  short  two-word sequences if  
  219. he'd like:  "spare tire"  is fine,  but things like   
  220. "antidisestablishmentarianism   blivet"   should   be avoided.)
  221.  
  222. Also, some  words are  inherently funnier  than others.  For 
  223. example, there are more humorous possibilities in "rutabaga" and 
  224. "slimy"  than in  "boy" and  "nice", even  though  these words  
  225. are   of  the   same  types   (noun  and   adjective, 
  226. respectively).   Try to  steer the group toward snappy, off-the-
  227. wall words and away from ordinary words used in everyday 
  228. conversation.
  229.  
  230. When the  computer reaches the end of the text file, it will stop 
  231. and  tell you  to press  a key  to display  the  story.  Gather 
  232. all  your guests  around the screen and have one read the story  
  233. aloud.   With some  luck (and  some skill on your part in  
  234. choosing the  text and fillin spaces and in guiding the fillins  
  235. toward humorous  words), your guests will spend the next few 
  236. minutes falling over themselves laughing.
  237.  
  238. If the  story is especially good ("a keeper"), you can print it 
  239. to  LPT1 or save it to disk.  In the latter case, BE SURE not to 
  240. use the same file name in storing the merged story as you used in 
  241. setting up the text file, or your original input will be 
  242. overwritten and therefore not available for re-use.
  243.  
  244.  
  245. Supplied disk files
  246.  
  247. The following is a listing of files supplied with ALFIE:
  248.  
  249.      ALFIE.EXE      The program
  250.      ALFIE.DOC      This manual
  251.      RECIPE.FIL     A sample input file
  252.      RECIPE.LIB     Output from a sample session using
  253.                     RECIPE.FIL as input.
  254.      PIRATE.FIL     Another sample input file, illlustrating
  255.                     special word types and rated R
  256.      PIRATE.LIB     The resulting output file from the above
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                            - Page 4 -
  264.                             
  265.  
  266.                   ALFIE Shareware Notification
  267.  
  268.  
  269. If you use ALFIE and find it enjoyable, your shareware 
  270. contribution of $8.00 will be gratefully accepted.  Registered 
  271. users will receive future upgrades at no charge.  Make checks 
  272. payable to Barbara Baser and mail to:
  273.  
  274.                       Cogitate, Inc.
  275.                       P. O. Box 413
  276.                    Southfield, MI 48034
  277.  
  278. If you have suggestions for improvements or features you'd like 
  279. to see in future versions, or if you find any program errors or 
  280. run into problems, you can contact me on CompuServe (76703,4252),
  281. or Delphi (MSWIZ) detailing the problem you are encountering.  
  282.  
  283. You are encouraged to upload ALFIE.ZIP to other BBSs and on-line 
  284. services; however, the archived file must be uploaded in its 
  285. entirety and contain all the originally supplied files, 
  286. documentation, and this shareware notice.  ALFIE may not be sold 
  287. as a commercial program; doing so is illegal and contrary to 
  288. United States copyright law.
  289.  
  290.  
  291.          ----------------end-of-author's-documentation---------------
  292.  
  293.                         Software Library Information:
  294.  
  295.                    This disk copy provided as a service of
  296.  
  297.                         The Public (Software) Library
  298.  
  299.          We are not the authors of this program, nor are we associated
  300.          with the author in any way other than as a distributor of the
  301.          program in accordance with the author's terms of distribution.
  302.  
  303.          Please direct shareware payments and specific questions about
  304.          this program to the author of the program, whose name appears
  305.          elsewhere in  this documentation. If you have trouble getting
  306.          in touch with the author,  we will do whatever we can to help
  307.          you with your questions. All programs have been tested and do
  308.          run.  To report problems,  please use the form that is in the
  309.          file PROBLEM.DOC on many of our disks or in other written for-
  310.          mat with screen printouts, if possible.  The P(s)L cannot de-
  311.          bug programs over the telephone.
  312.  
  313.          Disks in the P(s)L are updated monthly, so if you did not get
  314.          this disk  directly from the P(s)L,  you should be aware that
  315.          the files in this set may no  longer be the current versions.
  316.  
  317.          For a copy of the latest monthly software library newsletter
  318.          and a list of the 1,000+ disks in the library, call or write
  319.  
  320.                         The Public (Software) Library
  321.                               P.O.Box 35705
  322.                            Houston, TX 77235-5705
  323.                                (713) 665-7017
  324.  
  325.  
  326.  
  327.          ----------------end-of-author's-documentation---------------
  328.  
  329.                          Software Library Information:
  330.  
  331.                     This disk copy provided as a service of
  332.  
  333.                            Public (software) Library
  334.  
  335.          We are not the authors of this program, nor are we associated
  336.          with the author in any way other than as a distributor of the
  337.          program in accordance with the author's terms of distribution.
  338.  
  339.          Please direct shareware payments and specific questions about
  340.          this program to the author of the program, whose name appears
  341.          elsewhere in  this documentation. If you have trouble getting
  342.          in touch with the author,  we will do whatever we can to help
  343.          you with your questions. All programs have been tested and do
  344.          run.  To report problems,  please use the form that is in the
  345.          file PROBLEM.DOC on many of our disks or in other written for-
  346.          mat with screen printouts, if possible.  PsL cannot debug pro-
  347.          programs over the telephone, though we can answer questions.
  348.  
  349.          Disks in the PsL are updated  monthly,  so if you did not get
  350.          this disk directly from the PsL, you should be aware that the
  351.          files in this set may no longer be the current versions. Also,
  352.          if you got this disk from another vendor and are having prob-
  353.          lems,  be aware that  some files may have become corrupted or
  354.          lost by that vendor. Get a current, working disk from PsL.
  355.  
  356.          For a copy of the latest monthly software library newsletter
  357.          and a list of the 2,000+ disks in the library, call or write
  358.  
  359.                            Public (software) Library
  360.                                P.O.Box 35705 - F
  361.                             Houston, TX 77235-5705
  362.  
  363.                                 1-800-2424-PSL
  364.                                  MC/Visa/AmEx
  365.  
  366.                           Outside of U.S. or in Texas
  367.                           or for general information,
  368.                               Call 1-713-524-6394
  369.  
  370.                           PsL also has an outstanding
  371.                           catalog for the Macintosh.
  372.  
  373.